===========================================
 Last Stand Mod for GTA V Story Mode
===========================================

Version: 1.0  
Author: MO3IZO  
GitHub: https://github.com/Mouataz86/LastStand  

IMPORTANT:  
This mod is for single-player use only. Do not use in GTA Online as this may lead to a ban.

-------------------------------------------
Overview
-------------------------------------------
Last Stand is a lightweight, configurable mod that enhances gameplay immersion during combat. When the player's health drops to a critical level, the mod automatically triggers a temporary boost to give the player a final chance to survive and retaliate.

Features:
- Triggers when player's health is low.
- Temporarily increases health and armor.
- Grants a minigun with full ammo Temporary for counter-attack.
- Displays a countdown timer during Last Stand (Def = 20sec ).
- Cooldown period prevents repeated activations ( a 60sec cool down ).
- Optional notification when Last Stand becomes available (Once cooldown hit the 0, you will receive alert ).
- Clean and customizable via INI file.

-------------------------------------------
Requirements
-------------------------------------------
To run this mod, you must have:
- Grand Theft Auto V (PC version)
- ScriptHookV by Alexander Blade
- ScriptHookVDotNet (v3.7.0 or latest nightly)

ScriptHookVDotNet:
https://github.com/scripthookvdotnet/scripthookvdotnet

-------------------------------------------
Installation
-------------------------------------------
1. Ensure you have a folder named "scripts" inside your GTA V directory.
   If not, create it manually.

2. Copy the following files into the "scripts" folder:
   - LastStand.dll
   - LastStand.ini

3. Launch GTA V in Story Mode.
   The mod will load automatically.

-------------------------------------------
INI Configuration (LastStand.ini)
-------------------------------------------

[General]
TriggerHealth=110          ; Health threshold to trigger Last Stand
Duration=20                ; Duration of Last Stand in seconds
Cooldown=60                ; Cooldown before Last Stand can activate again
EnableSound=true           ; Enables sound when Last Stand activates
EnableReadyNotification=true ; Shows a notification when Last Stand is available

You can adjust these values to fit your preferred gameplay experience.

-------------------------------------------
Troubleshooting
-------------------------------------------
- Mod not working?
  Make sure ScriptHookV and ScriptHookVDotNet are correctly installed.
  Ensure LastStand.dll and LastStand.ini are placed inside the "scripts" folder.

- Game crashes or doesn't start?
  Double-check your ScriptHookVDotNet version matches your GTA V version.

- Sound does not play?
  Ensure "EnableSound" is set to true in the INI file.

-------------------------------------------
Credits
-------------------------------------------
Developed by MO3IZO  
Built using ScriptHookVDotNet  

-------------------------------------------
License
-------------------------------------------
This mod is free to use and distribute under the MIT License.  
Commercial use or resale is not permitted.

